More additions

svn path=/trunk/; revision=21943

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index b35d73420607864379817cf4524a3320306ba229..52b48979d82f7d0676162a1b5733b06c6e2077d5 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2008-12-27  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/gtk-sections.txt: Add GtkEntryIconPosition
+
+       * gtk/tmpl/gtkentry.sgml: Add note about a11y concerns.
+
 2008-12-26  Matthias Clasen <mclasen@redhat.com>
 
        * gtk/tmpl/gtkentry.sgml: Mention new functionality

diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index b7497a2a0513681480d6a7ac628f452c47c5493d..326fea9e638c15b907838b17884f5eff6bad4d3c 100644 (file)
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -1260,6 +1260,7 @@ gtk_entry_get_progress_fraction
 gtk_entry_set_progress_pulse_step
 gtk_entry_get_progress_pulse_step
 gtk_entry_progress_pulse
+GtkEntryIconPosition
 gtk_entry_set_icon_from_pixbuf
 gtk_entry_set_icon_from_stock
 gtk_entry_set_icon_from_icon_name

diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml
index d09ee4af54b3705e985ba7c04b2d88e83ba5c05c..323fa1f260a4ba20b18751972ae8536068d22552 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkentry.sgml
@@ -25,16 +25,26 @@ a password entry. The warning can be turned of with the
 </para>
 <para>
 Since 2.16, GtkEntry has the ability to display progress or activity 
-information behind the text. To make an entry display progress or activity
-information, use gtk_entry_set_progress_fraction() or
-gtk_entry_set_progress_pulse_step().
+information behind the text. To make an entry display such information, 
+use gtk_entry_set_progress_fraction() or gtk_entry_set_progress_pulse_step().
 </para>
 <para>
 Additionally, GtkEntry can show icons at either side of the entry. These
 icons can be activatable by clicking, can be set up as drag source and
 can have tooltips. To add an icon, use gtk_entry_set_icon_from_gicon() or
 one of the various other functions that set an icon from a stock id, an
-icon name or a pixbuf.
+icon name or a pixbuf. To trigger an action when the user clicks an icon,
+connect to the #GtkEntry::icon-pressed signal. To allow DND operations
+from an icon, use gtk_entry_icon_set_drag_source(). To set a tooltip on 
+an icon, use gtk_entry_set_icon_tooltip_text() or the corresponding function
+for markup.
+</para>
+<para>
+Note that functionality or information that is only available by clicking 
+on an icon in an entry may not be accessible at all to users which are not 
+able to use a mouse or other pointing device. It is therefore recommended 
+that any such functionality should also be available by other means, e.g. 
+via the context menu of the entry.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->